home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1997 February
/
EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso
/
enigma
/
onlypc
/
java
/
_setup.lib
/
README.TXT
< prev
next >
Wrap
Text File
|
1996-01-11
|
12KB
|
324 lines
README for Symantec Café Lite
============================================================
Copyright (c) 1996 by Symantec Corporation. All Rights Reserved.
ABOUT THE "README.TXT" FILE
============================================================
This file, "readme.txt," provides essential information on
installing and using Symantec Café Lite.
The sections that follow provide information on
* What Symantec Café Lite includes
* What you need
* Installing Symantec Café Lite
* Building and Using Java Projects
* Important Points, Tips, and Workarounds
* Documentation
* Where to Go from Here
* Differences between Java Beta 1 and Beta 2
WHAT IS SYMANTEC CAFÉ LITE ?
============================================================
Symantec Café Lite is a set of tools that allow Windows developers
to edit, build, run, and debug Java applications within the Symantec
Integrated Development and Debugging Environment, under Windows 95
and Windows NT. This version supports Sun's Java Release Beta 2.
Symantec Café Lite includes instant creation of Java applets and
Java applications using AppExpress, and features advanced editing
and project management capabilities for Java development.
This is a special early-release version of the product.
Please read the limitations in "Important Points, Tips, and
Workarounds" below, and send any comments you have, or requests
for more information, to javainfo@symantec.com.
WHAT YOU NEED
============================================================
* An IBM Personal Computer or 100 percent compatible
* 16MB RAM
* Windows 95 or Windows NT 3.51
* CD ROM Drive
* 25 MB free hard disk space
INSTALLING SYMANTEC CAFÉ LITE
============================================================
1. Insert the CD-ROM in the CD-ROM Drive on your system.
2. Choose Run from the Windows start Menu to display the Run dialog.
3. type:
[d]:\setup.exe
where [d] is the CD-ROM drive identifier, and click on OK.
4. Follow the instructions on the screen and click on Next to proceed.
5. Select the directory in which you want to install. If you do not
specify another location the installer will install Symantec Café Lite
into C:\Café.
6. Click on Next. The installer will then install Symantec Café Lite
on your hard drive. This will take from 2 to 8 minutes depending on
the speed of your computer and CD-ROM Drive.
7. When the installation is complete, you will see a dialog box that
will allow you to restart your computer. Click on OK to restart and
allow the necessary changes to take effect.
Note:
To uninstall Symantec Café Lite, you can use the Windows 95
Add/Remove programs control panel, or under NT launch the
uninstall icon in the Symantec Café Group.
BUILDING AND USING JAVA PROJECTS
============================================================
We suggest that you start by using and examining one of the demo
projects. The section below discusses how to start by using the
ArcTest demo. Later you can use AppExpress to generate new Java
applications, or generate projects manually.
Using the Java Demos
------------------------------------------------------------
Launch Symantec Café Lite
Under Windows 95 you can launch Symantec Café Lite from the
Start | Programs menu.
Open Project
You'll see the Symantec Café startup screen. Open the ArcTest demo
project, located in Café\java\demo\ArcTest and named arctest.prj.
Choose Build
You will notice a brief delay as the Java compiler is invoked and
processes the ArcTest.java source file. The compiler will produce
the runtime class file ArcTest.class and some additional classes
in the ArcTest directory.
Choose Execute Program
After a brief pause, the ArcTest applet will appear and run.
Note:
The first time you a run a Java application after installing, you will
see a copyright notice from SUN Computer. To accept the terms and use
the Java software on your computer, click on Accept.
Choose Project Arguments...
Applets are invoked by running appletviewer.exe on the HTML text file
specified in the Project | Arguments dialog. Choose this to see that
the file run by the IDDE is named example1.html. You can specify
another HTML file to run instead, such as example2.html. If you are
interested, you can open example1.html in the editor to see the
format for invoking an applet from an HTML file.
Using AppExpress
------------------------------------------------------------
In Symantec Café Lite, AppExpress offers three application types:
Java Applet, Java SDI, and Java Console. These are extremely
simple examples to demonstrate Java applications.
This is how to create new simple Java projects using AppExpress:
1. Select the menu item Project|New. DO NOT alter or fill in
the project name. Select a directory, check 'Use AppExpress'
and click Finish.
2. In The AppExpress main dialog select one of the three Java
application types and click Finish. (Don't change the project name
on the Miscellaneous dialog.)
3. Build and execute program as usual.
Please note the following limitation:
In Symantec Café Lite, the AppExpress names are all preassigned, and
everything has the same name: "Simple." (The file Simple.java contains
the class Simple, and the project file is Simple.prj.)
Note: If you assign your own project name to one of these sample Java
projects, it will generate and build, but Project | Execute Program
won't work. If you want to name your project something else, you can,
but then you must change the following occurrences of "Simple" to be
exactly the same as your project name, including case-matching:
for all:
- Simple.java (rename the file)
- class Simple inside Simple.java
for Java SDI add:
- constructor for class Simple inside Simple.java
for Java Applet add:
- APPLET CODE="Simple.class" inside Simple.html
then EITHER
- Simple.html (rename the file)
OR
- change "<projname>.html" in Project Arguments
In the case of a Java applet, what the idde executes is based on the
project arguments, not the project name as in all other cases.
See further discussion of applets below.
Generating New Projects Manually
------------------------------------------------------------
If you have existing Java source code, you can use ProjectExpress
to generate your own projects manually; just specify either Applet
or Console. Console apps are Java stand-alone, i.e., "non-applet,"
runnable components.
The Java source files (.java) contain the source code for your Java
classes. At build time, the compiler produces a Java class file
(.class) with the same basename as the source file.
When you choose Execute Program for a Java Console app, the IDDE runs
the Java interpreter on a class with the same name as your project.
Java applets, in contrast to console applications, are called from
Hypertext links, for example from links in internet Web pages. The
links are written in an editable text file using the Hypertext Markup
Language (HTML).
Applet projects require you to write the HTML file to invoke your
applet. See the demo projects for examples.
The .html file supplies the link that allows your JAVA applet to be
launched and debugged within the Symantec IDDE. You specify the name
of the HTML file to be run in the "Project | Arguments" menu choice
in the Symantec Café Lite environment.
IMPORTANT POINTS, LIMITATIONS, TIPS, AND WORKAROUNDS
============================================================
Symantec Café Lite requires you to run under either Windows 95 or
Windows NT 3.51.
File names and class names must be identical in spelling and
CAPITALIZATION. This is a requirement of the Java compiler and
interpreter.
If the project is of type Applet, the Symantec Environment runs
appletviewer on the .html file that is specified in the Project
Arguments dialog; otherwise it runs the Java interpreter on the
.class file which has the same basename as the current project.
The applet class specified in the HTML file must be capitalized
exactly the same as the class name in the .java file.
There is currently no graphical debugger for Java. When you choose
"Start/Restart Debugging" the IDDE launches the Sun command-line
debugger.
If you attempt to debug, you MUST have TCP/IP installed.
If not, the Sun command-line debugger will hang.
Symantec Café Lite projects must not have names containing spaces.
The Java compiler currently will not run from a WIN95 shared drive.
The symptom is the same as if CLASSPATH were not set (i.e., compiler
complains that it can't find the classes). This problem is under
investigation and we hope to have a fix soon. Symantec Café Lite
can be run from a Netware volume.
Some of the Sun Demo programs using sound are not well behaved if
you are running a machine that does not have a sound card. You may
have to use Cntl-Alt-Delete to terminate a misbehaving java applet
if this happens.
AppExpress
------------------------------------------------------------
The Java SDI sample is not fully functional. Only the menu items
Help | About and File | Exit have code behind them.
Compiler support
------------------------------------------------------------
The compiler does not accurately report the number of lines compiled.
Certain Java compiler switches are not currently supported in the IDDE.
For more information you may want to run the java compiler, javac.exe,
directly from the command line.
Earlier versions of Java
------------------------------------------------------------
Earlier Java releases from Sun have different class names and
functionality in comparison with the current release. For more
information please refer to Sun's http site at http:\\java.sun.com.
DOCUMENTATION
============================================================
The folder Sun Doc contains the latest Java documentation available
from Sun when this CD was mastered. The latest Java documentation
is always available at Sun's web site.
Most of the files are in HTML and can be viewed with your favorite
browser, such as CyberJack or NetScape. This includes the current
API and Programmer's Guide. The Java Language specification is
provided as a postscript file. It can be printed on any PostScript
printer or viewed with utilities such as GhostScript.
WHERE TO GO FROM HERE
============================================================
There is a host of information available at http:\\java.sun.com.
The Symantec World Wide Web site is located at www.symantec.com.
For additional information about Symantec Java support, please
contact javainfo@Symantec.com.
For Java development, a good book to start with is Arthur van Hoff's
"Hooked on Java", Addison Wesley, ISBN 0-201-48837-X.
DIFFERENCES BETWEEN SUN JAVA BETA1 AND BETA 2
============================================================
Symantec Café Lite supports Sun's Java beta 2 release including the
final Java 1.0 API. This API is compatible with Netscape 2.0 Beta 4
and later versions.
There is now an empty finalize() method in Object.
The definition of clone in Object is now as follows:
protected native Object clone() throws CloneNotSupportedException;
Thus if a class has not implemented the interface Clonable, a call
to clone will fail and give the error CloneNotSupportedException.
Errors previously reported as warnings are now errors, and must be
handled in your code.
The meaning of the 'protected' modifier has changed slightly.
Contravariant return types are not supported. Overriding methods
must have the same return type as the overridden method.
Loading classes from zip files is now supported by both the compiler
and the runtime class loader.
There have been several bug fixes, security improvements and API
changes since the BETA 1 release.
All of these changes are described more completely at Sun's web site:
http//java.sun.com/JDK-beta2/changes.html.